home *** CD-ROM | disk | FTP | other *** search
/ Practical Algorithms for Image Analysis / Practical Algorithms for Image Analysis.iso / TARFILE.GZ / tarfile / util / linux / tofrodos-1.1 / readme.txt < prev    next >
Text File  |  1999-09-11  |  6KB  |  153 lines
  1. tofrodos Ver 1.1
  2. Copyright (c) 1996 by Christopher S L Heng. All rights reserved.
  3. ----------------------------------------------------------------
  4.  
  5. $Id: readme.txt 1.3 1996/12/16 17:50:37 chris Exp $ /*
  6.  
  7.  
  8. CONTENTS
  9. --------
  10.  
  11. 1. WHAT IS TOFRODOS?
  12. 2. WHAT'S NEW IN VERSION 1.1
  13. 3. HOW TO INSTALL TOFRODOS?
  14. 4. PORTING TO OTHER SYSTEMS OR COMPILERS
  15. 5. COPYRIGHT AND CONTACTING THE AUTHOR
  16.  
  17.  
  18. 1. WHAT IS TOFRODOS?
  19. --------------------
  20.  
  21. DOS text files traditionally have CR/LF (carriage return/line feed) pairs
  22. as their new line delimiters while Unix text files traditionally have
  23. LFs (line feeds) to terminate each line.
  24.  
  25. tofrodos comprises two programs, "fromdos" and "todos", which convert
  26. text files to and from these formats. Use "fromdos" to convert DOS
  27. text files to the Unix format, and "todos" to convert Unix text files
  28. to the DOS format.
  29.  
  30.  
  31. 2. WHAT'S NEW IN VERSION 1.1
  32. ----------------------------
  33.  
  34. a. The Linux version had a bug which surfaced when you ran todos or
  35. fromdos on a file on a different filesystem from that of the current
  36. directory. Fixed.
  37.  
  38. b. The Linux version now forms the backup filename by replacing the
  39. existing file extension (if any) with a ".bak" extension instead of
  40. simply appending ".bak" to the filename. This is necessary for MSDOS
  41. filesystems which cannot have multiple periods in the filenames.
  42.  
  43.  
  44. 3. HOW TO INSTALL TOFRODOS?
  45. ---------------------------
  46.  
  47. The tofrodos package comes with sources, documentation and binaries for
  48. both Linux and DOS.
  49.  
  50. To install the DOS versions, simply copy todos.exe and fromdos.exe to
  51. a directory on your path. You will have to read the manual page from
  52. a Unix system (like Linux) or use a DOS program that can read Unix manual
  53. pages. For a short summary of options, run the program with the -h or
  54. /h option. And of course, you can always read the source code.
  55.  
  56. To install the Linux versions, you have to find out if your system
  57. supports ELF. If it does, use the todos.elf and fromdos.elf binaries.
  58. These probably require the shared libraries 5.2.18 or above since I
  59. compiled them with 5.2.18. To install, do the following:
  60.  
  61.     make install.elf
  62.  
  63. If your system can only run a.out binaries, you probably have to use
  64. todos.out and fromdos.out. I compiled these binaries with 4.7.2 of
  65. the libraries and they probably require at least these versions.
  66. To install, do the following:
  67.  
  68.     make install.out
  69.  
  70. If you are not sure whether you have an ELF or a.out system, or if you
  71. like to recompile the binaries yourself, simply do
  72.  
  73.     make install
  74.  
  75. This will recompile and install the binaries. To install them somewhere
  76. other than /usr/local/bin, redefine BINDIR and MANDIR for the binary and
  77. manual page destinations respectively. For example, to install the
  78. binaries in /usr/bin and the manual page in /usr/man/man1, do
  79.  
  80.     make BINDIR=/usr/bin MANDIR=/usr/man/man1 install
  81.  
  82. Or, if you like, you can always compile with "make all" and install the
  83. binaries and manual page yourself manually.
  84.  
  85. To read the manual page, simply type
  86.  
  87.     man fromdos
  88.  
  89.  
  90. 4. PORTING TO OTHER SYSTEMS OR COMPILERS
  91. ----------------------------------------
  92.  
  93. If you want to compile tofrodos for a system other than Linux, you may
  94. or may not have some work in store for you. The program is actually
  95. VERY trivial, so the work you need to do is probably (hopefully) minimal.
  96.  
  97. The first place to look into is probably the config.h file, where I
  98. tried to place as much system and compiler macros as I could bother.
  99.  
  100. If you are compiling on other Unix systems, tweaking the config.h file
  101. macros may well be all that you need to do. I don't know. I never tried
  102. it on any Unix system or Unix-clone other than Linux. Let me know how
  103. it works out, especially if you had to hack something other than changing
  104. the values of the macros in config.h to get it to work.
  105.  
  106. If you are compiling for DOS, you may need to do some work. Depending on
  107. your compiler, you may need to find replacements for some of the functions
  108. which I assume are present in the compiler's default libraries. I tried
  109. to identify potential missing functions in the config.h file, but it is
  110. probably not complete. Remember also that if you want the program to
  111. handle wildcard arguments your runtime system must expand command line
  112. arguments before passing them to main(), since COMMAND.COM does not
  113. automatically expand wildcards the way Unix shells do. If you use
  114. Borland C/C++ 3.1, this probably means that you will need to link with
  115. wildargs.obj. If you use Watcom C/C++ you will need to use the source
  116. for wildargv.c (in the watcom SRC directory). Please don't ask me how
  117. to get the program to compile/link for DOS for any compiler. If you
  118. run into too much trouble compiling it for DOS, I would suggest that
  119. you either use my precompiled executables or just rewrite the whole
  120. program. The program is too simple to waste time trying to port to
  121. any brain-dead system or compiler.
  122.  
  123.  
  124. 5. COPYRIGHT AND CONTACTING THE AUTHOR
  125. --------------------------------------
  126.  
  127. The program and its accompanying files and documentation are
  128. Copyright (c) 1996 by Christopher S L Heng. All rights reserved.
  129. They are distributed under the terms of the GNU General Public License
  130. Version 2, a copy of which is enclosed in this package in the file COPYING.
  131.  
  132. You can contact me at the following email addresses:
  133.     ChristopherHeng@pobox.org.sg
  134.     cyfheng@singnet.com.sg
  135.  
  136. The latest version of tofrodos can always be retrieved from my web page:
  137.     http://www.singnet.com.sg/~cyfheng/
  138.  
  139. While I generally like to hear from you if you are using this program,
  140. especially if you find any bugs in it, I make no promises about fixing
  141. anything or even replying. If you do email me, please also let me have
  142. the following information:
  143.  
  144.     1. The version of tofrodos that you are using;
  145.     2. The operating system (and its version) on which you are
  146.     running the program (eg, Linux 1.2.13, or MSDOS 6.22, or both).
  147.     If the bug only surfaces in one of the operating systems and not
  148.     the other, please also note this.
  149.     3. Any other information which you think might be relevant.
  150.  
  151. This will help me give you a more relevant reply (and also to trace
  152. whatever bugs that may be present).
  153.